home *** CD-ROM | disk | FTP | other *** search
/ The Learning Curve / The Learning Curve (Weird Science, 1996).iso / mathematics / plotters / dataplot / dataplot.help < prev    next >
Encoding:
Text File  |  1991-08-27  |  31.9 KB  |  750 lines
  1.  
  2.                       DataPlot User's Guide
  3.  
  4.                    Version 2.10 - 24 June 1991
  5.  
  6.                         Table of Contents
  7.  
  8.               INTRODUCTION . . . . . . . . . . . 1
  9.               STARTUP. . . . . . . . . . . . . . 2
  10.               KEYBOARD OPERATION . . . . . . . . 3
  11.               STOP . . . . . . . . . . . . . . . 4
  12.               DATASETS . . . . . . . . . . . . . 5
  13.               OPTIONS. . . . . . . . . . . . . . 6
  14.               DEFAULT OPTION VALUES. . . . . . . 7
  15.               INTERACTIVE OPTIONS. . . . . . . . 8
  16.               FILE READING . . . . . . . . . . . 9
  17.               CROSSHAIRS . . . . . . . . . . . .10
  18.               FUNCTIONS. . . . . . . . . . . . .11
  19.               MACROS . . . . . . . . . . . . . .12
  20.               PRINTERPLOT. . . . . . . . . . . .13
  21.               PLOTTEXT . . . . . . . . . . . . .14
  22.               RESCALE and REPLOT . . . . . . . .15
  23.               SKETCH FREEHAND. . . . . . . . . .16
  24.               HPGL and PLT:. . . . . . . . . . .17
  25.               DRAWFUNCTION . . . . . . . . . . .18
  26.               SCREENPRINT. . . . . . . . . . . .19
  27.               SCREENDUMP . . . . . . . . . . . .20
  28.               SAMPLE FILES . . . . . . . . . . .21
  29.               THE END. . . . . . . . . . . . . .22
  30.  
  31.  
  32.  
  33. 1.  INTRODUCTION
  34.  
  35. DataPlot2.1 makes 2-dimensional plots of data on the screen  and
  36. on dot matrix printers which are Epson MX-80 compatible.    Hard
  37. copy plots can also be  made  in  the  Hewlett-Packard  Graphics
  38. Language for driving pen  plotters.    If  the  PLT:  driver  is
  39. installed, then the output can be to any  preferences  supported
  40. dot matrix printer.  Screen plots can be made at any resolution,
  41. and may range in size from 200 x  100  pixels  to  full  screen.
  42. Screen prints are transferred to  paper  on  a  pixel  to  pixel
  43. basis.  Variable size paper plots can  be  made  to  dot  matrix
  44. printers, with the plots ranging from 4.5 to about 18  cm  on  a
  45. side.  Up to 100 sets of data may be plotted on one screen.   Up
  46. to 2 billion points can be in each data file, although it  would
  47. take an unreasonably long time to plot that many points.    Each
  48. file may have from 1 to 50 columns of numbers.    Plots  can  be
  49. saved as IFF  files.    There  is  also  a  macro  language  for
  50. repetitively plotting datasets using the same options.  At least
  51. one megabyte of ram is required.
  52.  
  53. DataPlot2.1 is easy to use.  It may be run from either WorkBench
  54. or the CLI.  Many items can be selected  from  the  mouse  menu.
  55. Nearly all options may be set  by  clicking  on  them  from  the
  56. options screen.  The keyboard may be used to select  several  of
  57. the mouse menu commands.  These single key shortcuts are  listed
  58. below under KEYBOARD OPERATION.
  59.  
  60. 2.  STARTUP
  61.  
  62. Start up DataPlot2.1 by typing the name from a shell or CLI,  or
  63. from WorkBench by double clicking  on  the  icon.    DataPlot2.1
  64. uses four system libraries.  In order to use them, four  special
  65. files, dos.bmap, exec.bmap, graphics.bmap,  and  intuition.bmap,
  66. are necessary.  They  are  included  on the Extras 1.3 disk.  If
  67. they are not found in the LIBS:  directory  or  in  t:,  then  a
  68. short version will be created in  t:  and deleted as the program
  69. ends.
  70.  
  71. A point-and-click file name requester is available when  reading
  72. a file.  Selecting the Requester box or pressing F8 calls up the
  73. file requester.  If  arp.library is in libs: and  BatchRequester
  74. is in c:, then the ARP file requester, which is faster than  the
  75. built-in one, will be used.
  76.  
  77. Otherwise, a built-in requester will be used which starts at the
  78. top level of disk drives and assigned directories.  Clicking  on
  79. a file name selects that file for reading  by  DataPlot2.1.    A
  80. file name can be entered from the keyboard by  clicking  on  the
  81. "File:" word at the top of the requester window.  Pressing ENTER
  82. ends the entry.  All  ".info"  files  are  eliminated  from  the
  83. requester.  The list of files is sorted without regard to  case.
  84. Clicking  on  a  directory  name  results  in   a   display   of
  85. subdirectories and files.  The path is shown in the second  line
  86. of the requestor.  If there are no files from which  to  choose,
  87. then the display will indicate that and you may select cancel or
  88. parent directory from the bottom of the requester.
  89.  
  90. Upon start up, DataPlot2.1  sets  up  the  default  options  (as
  91. stated below) and opens  a  custom  640  x  200  pixel,  4-color
  92. screen.  Selecting the "Plot a dataset" menu item will bring  up
  93. a file name request window.  The specified file will be read  to
  94. determine any options to be applied, such as which column  is  X
  95. and which is Y.  Options contained  in  the  dataset  file  will
  96. override options set from the keyboard, unless USE  NO  is  set,
  97. meaning that DataPlot2.1 is  not  to  use  any  of  the  in-file
  98. options.  After reading the options, the file will be read again
  99. to obtain the data.  Automatic scaling information is determined
  100. from the first file to be read which actually contains any  data
  101. points.  A file could have only options and no data, if desired.
  102. After the scaling is performed, the file is read again and  each
  103. point is plotted.  Therefore, KYBD: may not be used  as  a  data
  104. file name.
  105.  
  106. The plot can be transferred to paper by selecting the menu  item
  107. "Screen Print" or "Paper Plot".  The  "Screen  Print"  selection
  108. will make a screen pixel to printer pixel copy of the plot.  The
  109. "Paper Plot" selection will read the data files again and make a
  110. plot  at  the  size  specified.    (This  is   the   DataPlot1.0
  111. capability.)  The Y-axis label will be printed  horizontally  at
  112. the top of the Y-axis in the paper plot to Epson mode.  It  will
  113. be printed vertically in the HPGL mode.  Plots can  be  made  to
  114. any preferences supported printer by selecting the  HPGL  output
  115. to be the PLT: device, which will rasterize the HPGL output  and
  116. send it to the printer.  IF the output is to  a  file,  then  an
  117. ASCII file of HPGL commands will be created.  That file  may  be
  118. copied to PLT: for a printer plot.  If  you  copy  the  file  to
  119. PLT:S, then the plot will be drawn on a high-resolution  screen,
  120. giving a preview of the printer plot.
  121.  
  122. 3.  KEYBOARD OPERATION
  123.  
  124. In addition to using  the  mouse  to  select  operations  to  be
  125. performed, you may enter the characters shown in parentheses  in
  126. the pull-down  mouse  menus  and  shown  here  to  activate  the
  127. indicated commands:
  128.  
  129.   Help             (Help key)
  130.   New Plot         (N)
  131.   Plot a Dataset   (D)
  132.   Draw a Function  (F)
  133.   Execute a Macro  (M)
  134.   Save as IFF file (F1)
  135.   Save as a Macro  (F2)
  136.   Crosshairs       (C)
  137.   Rescale & Replot (R)
  138.   Plot text        (T)
  139.   Sketch Freehand  (S)
  140.   Set an Option    (O)
  141.   Quit             (Q)
  142.   Printer Plot to Preferences Printer      (P)
  143.   Screen Print to Epson compatible printer (F3)
  144.   Printer Plot to Epson compatible printer (F4)
  145.   Printer Plot to HPGL output              (F5)
  146.   Screen Dump  to Preferences Printer      (F6)
  147.  
  148. Case is insignificant.  The left and right  arrow  keys may be
  149. used to position the cursor  when  entering  a  value from the
  150. keyboard.  Some requestor boxes include boxes to erase, accept
  151. (OK), and cancel the operation with the mouse.  Whether  these
  152. boxes are shown or not, certain keys may be used as follows:
  153.  
  154.  Erase the entry       F9, control-X, or control-U
  155.  Cancel the operation  ESCape
  156.  Accept the entry      F10 or ENTER
  157.  
  158. These functions are available  by  clicking  the  mouse  in  the
  159. appropriately named box.  The cursor can be  positioned  in  the
  160. entry by use of the mouse and the cursor arrow keys.
  161.  
  162. 4.  STOP
  163.  
  164. An operation, such as plotting a curve or printing a plot may be
  165. halted with a control-C.  The screen will flash and  beep,  then
  166. after the current point or line is processed, the operation will
  167. be aborted.  Two control-C's within one  second  will  terminate
  168. DataPlot.
  169.  
  170. 5.  DATASETS
  171.  
  172. A data file consists of any number of option lines  followed  by
  173. the data points.  Each line of data consists of  from  1  to  50
  174. data values separated by a comma or spaces or both a  comma  and
  175. spaces.  By default, the first column of  data  contains  the  X
  176. axis values, and the second column contains the Y  axis  values.
  177. The options XCOLUMN=n and YCOLUMN=n (where n may range from 1 to
  178. 50) may be used to specify which  columns  of  data  are  to  be
  179. plotted.
  180.  
  181. If the data consists of only one  column  of  values,  then  the
  182. option "DATA = UNIFORM" may be used.  DataPlot2.1 will then read
  183. only the Y values from the file, with the X values starting at 1
  184. and incremented by 1 with each point.  The program  detects  the
  185. start of numeric data following option lines (which may be blank
  186. lines) when the first non-blank character  is  numeric,  meaning
  187. the digits 0-9, +, -, or a decimal point.    The  first  several
  188. lines of data may be skipped by setting the option SkipPoints=n.
  189. Data is normally read until an end of file is reached.   If  the
  190. entire file is not to be read, then the option  MaxPoints=n  can
  191. be used to specify how many points to read.  Reading  will  stop
  192. sooner if an end of file is detected.
  193.  
  194. The data file may  also  consist  of  just  one  column  if  the
  195. Xcolumn=1 and Ycolumn=1 options  are  used.    With  only  these
  196. options, the plot would simply be a straight line.    Using  the
  197. FUNCTION options, one could plot a number  of  different  curves
  198. using that same file as the input dataset.
  199.  
  200. A data file may consist of only options.  If  the  same  set  of
  201. options are always used, you may wish to make a  file containing
  202. just them.  Such a file could be named MACRO.AUTO and placed  in
  203. the default directory.  It would then be executed  automatically
  204. whenever DataPlot2.1 is run from that directory.  Another choice
  205. is to create a macro file DataPlot.init in the S: directory, and
  206. it will also be executed automatically when DataPlot2.1  is run.
  207. DataPlot.init might have your choice of colors, for instance, or
  208. perhaps your choice of screen resolution  and  depth.  It  could
  209. simply speak a message telling you that DataPlot2.1 is ready.
  210.  
  211. To save time when plotting  a  very  large  dataset  with  known
  212. minima and maxima, one could set  the  proper  limits  with  the
  213. XMINIMUM, XMAXIMUM,  YMINIMUM,  and  YMAXIMUM  options.    If  a
  214. minimum or maximum value is set, then the specified  value  will
  215. be used for autoscaling, with the other values obtained from the
  216. first  dataset.    For  manual  scaling,  one  must   also   set
  217. SCALE=MANUAL, and supply XSTEPS and YSTEPS.  (The default number
  218. of steps is 5).  With manual scaling, the  user  is  responsible
  219. for selecting values that will result in numerics  with  a  nice
  220. appearance.
  221.  
  222. 6.  OPTIONS
  223.  
  224. An option line consists of an option name, which is always  just
  225. one word, followed by an equal sign or a  space  and  an  option
  226. value.  The spelling of the option may be truncated.  Upper case
  227. is not required.  An unrecognized option in a data file is  just
  228. ignored and the processing continues.  The  option  PRINTOPTIONS
  229. will result in an output to the currently specified  PRINTERPORT
  230. of the current values of the options, which are:
  231.  
  232.  TITLE = text             (Text for plot title)
  233.  XLABEL = text            (Text for X axis label)
  234.  YLABEL = text            (Text for Y axis label)
  235.  MARKERS = YES or NO      (Draw a marker for each data point, YES)
  236.            1 - 10         (increments the marker number, else use
  237.                           (the indicated marker)
  238.  SEGMENTS = YES or NO     (Draw line segments between data points)
  239.  XCOLUMN = 1 thru 50      (Selects the column with the x values)
  240.  YCOLUMN = 1 thru 50      (Selects the column with the y values)
  241.  ZCOLUMN = 1 thru 50      (Selects the column with the z values for
  242.                            use with a function)
  243.  ErrorColumn = 1 thru 50  (Selects  the  column  with  the  error
  244.                            values, an error bar will be drawn)
  245.  REMARK text              (Ignore this comment line)
  246.  ;text                    (Ignore this comment line also)
  247.  DATA = X,Y or UNIFORM    (Data is X,Y or just uniformly spaced Y)
  248.  SkipPoints N             (Skip the first N points)
  249.  MaxPoints N              (Plot only N points)
  250.  PrinterType EPSON        (Sets the escape code for dots/lf,
  251.                            Epson MX-80 uses ESC A 8)
  252.           or IBM          (Uses ESC A 8 ESC 2)
  253.           or EPSONQ       (Uses ESC + 40 for 40/360 inch lf)
  254.  NEWPAGE                  (Eject page when finished with plot)
  255.  NOTE text                (Notes will be printed below the plot
  256.                            for Epson printer plots)
  257.  
  258.  YFUNCTION algebraic-expression  (Applies to the y-axis)
  259.  XFUNCTION algebraic-expression  (Applies to the x-axis)
  260.  FUNCTION algebraic-expression   (A function to be applied to the
  261.                                   y-axis values, including the
  262.                                   following:)
  263.  
  264.          SIN  (Sine, angle in radians for all functions)
  265.          COS  (Cosine)
  266.          TAN  (Tangent)
  267.          ASIN (Arcsine)
  268.          ACOS (Arccosine)
  269.          ATAN (Arctangent)
  270.          SINH (Hyberbolic sine)
  271.          COSH (Hyberbolic cosine)
  272.          TANH (Hyberbolic tangent
  273.          EXP  (e raised to the value)
  274.          LOG  (Log to base 10)
  275.          LN   (Natural log)
  276.          SQRT (Square root)
  277.          ABS  (Absolute value)
  278.          INT  (Integer part)
  279.          FRAC (Fractional part)
  280.          ^    (Exponentiation)
  281.          **   (Exponentiation)
  282.          X    (The value read from the X-column)
  283.          Y    (The value read from the Y-column)
  284.          Z    (The value read from the Z-column)
  285.          DATE (YYMMDD to YY.fraction)
  286.  
  287. A blank expression erases the function; the variable is plotted.
  288.  
  289. The following options may NOT be set after the first file:
  290.  
  291.  SCALE = MANUAL or AUTO (Manual or automatic scaling)
  292.  XMINIMUM = value       (Minimum X value for scaling)
  293.  XMAXIMUM = value       (Maximum X value for scaling)
  294.  XSTEPS = 1-30          (Number of x steps for scaling)
  295.  YMINIMUM = value       (Minimum Y value for scaling)
  296.  YMAXIMUM = value       (Maximum Y value for scaling)
  297.  YSTEPS = 1-30          (Number of y steps for scaling)
  298.  XAXIS = LINEAR or LOGARITHMIC (X axis type)
  299.  YAXIS = LINEAR or LOGARITHMIC (Y axis type)
  300.  NUMERICS = YES or NO   (Print numbers along the grid axes)
  301.  MAJORTICKS = YES or NO  (Draw major ticks, no grid lines)
  302.  GRIDS = YES or NO      (Draw grid lines, no major ticks)
  303.  MINORGRIDS = YES or NO (Draw minor grid lines for log axes)
  304.  GridTint = N           (Selects the color for the grid lines,
  305.                          the default is 1)
  306.  GRIDPATTERN DASHED or SOLID (Selects the grid line pattern)
  307.  YLABELSIZE = 2 or 1    (Sets Y label height, pixels not square)
  308.  
  309. Some options are primarily for use with macros or from the
  310. keyboard by the user while running DataPlot2.1:
  311.  
  312.  HELP   (Type this information to the screen)
  313.  
  314.  RESET  (Reset options to default values, may only be used
  315.          after a NewPlot command, does not affect colors)
  316.  
  317.  VOICE male or female  (Default is male)
  318.  
  319.  ChangeDirectory, CD, or CHDIR newdirectory (Change  the  default
  320.                         directory from  which files will be read.
  321.                         Using "CD ." in a macro  means to  change
  322.                         to the directory in which  the  macro  is
  323.                         located.)
  324.  
  325.  EpsonResolution 480 or 960  (The graphics mode for screen
  326.                               printing)
  327.  
  328.  LaserJetResolution 75, 150 or 300  (Size and resolution of
  329.                                      screen print)
  330.  
  331.  ScreenResolution 320x200   (Sets screen resolution, then executes
  332.                or 640x200    a NewPlot.  If there is insufficient
  333.                or 320x400    RAM, then screen depth or resolution
  334.                or 640x400    will be reduced automatically.)
  335.  
  336.  ScreenDepth 1-5     (Determines number of colors, 2^ScreenDepth,
  337.                       only after a NEWPLOT, default value is 2.)
  338.  
  339.  CurveColor 1-31 [r,g,b] (Select the color for the curve, can
  340.                           not exceed (2^ScreenDepth)-1.  The [red,
  341.                           green, blue] values are optional.)
  342.  
  343.  ColorPalette color,r,g,b (Set the RGB values for a color, 0-31
  344.                            with the red, green, and blue values
  345.                            ranging from 0 to 15.  Color 0 is the
  346.                            background, 1 is for text and the grid,
  347.                            and higher colors are for curves.)
  348.  
  349.  WindowSize 200,100 to 617,386  (Set window size, can be done with
  350.                     or 297,186   mouse before the first dataset is
  351.                                  plotted.)
  352.  
  353.  OnError WAIT, EXIT, or CONTINUE  (Determines whether macro
  354.                                    execution stops, DataPlot exits,
  355.                                    or action continues on an error)
  356.  
  357. 7.  DEFAULT OPTION VALUES
  358.  
  359. The default options are reset when a new plot is begun.  These
  360. are:
  361.  
  362.  Title = DATA PLOT
  363.  Xlabel = X
  364.  Ylabel = Y
  365.  Scale = auto
  366.  Xdirection = forward
  367.  Ydirection = forward
  368.  Xaxis = linear
  369.  Yaxis = linear
  370.  Numerics = yes
  371.  Grids = yes
  372.  MajorTicks = no
  373.  Newpage = no
  374.  Orientation = landscape
  375.  Printer = Epson
  376.  PrinterPort = PAR:
  377.  EpsonResolution = 480
  378.  LaserJetResolution = 75
  379.  Ylabelsize = 2
  380.  
  381.  If scale = manual is invoked, then the six following default
  382.  values are set, but may be changed.
  383.  
  384.  Xminimum = 0
  385.  Xmaximum = 10
  386.  Xsteps = 5
  387.  Yminimum = 0
  388.  Ymaximum = 10
  389.  Ysteps = 5
  390.  
  391. After a dataset is plotted, the following options are reset
  392. for the next file:
  393.  
  394.  Data X,Y
  395.  Markers yes (Incremented to the next marker type; there are 10)
  396.  Segments yes
  397.  SkipPoints 0
  398.  MaxPoints 2000000000
  399.  Xcolumn 1
  400.  Ycolumn 2
  401.  Zcolumn 0
  402.  ErrorColumn 0
  403.  Xfunction clear
  404.  Yfunction clear
  405.  
  406. 8.  INTERACTIVE OPTIONS
  407.  
  408. During interactive use of DataPlot2.1,  after  selecting  a  new
  409. plot with an N from the keyboard or from  the  mouse  menu,  the
  410. screen will be cleared and an options screen will be  presented.
  411. These options may be selected by clicking with the  mouse.   All
  412. options can also be set from the keyboard  by  just  typing  the
  413. name of the option and the value.  An area at the bottom of  the
  414. screen will be cleared and your entry will  appear  there.    An
  415. escape or mouse click  in  the  appropriate  box  will  end  the
  416. setting of options.  Clicking on an option which has only two or
  417. three valid  values will  automatically  change  the  option  to
  418. another valid value.  Clicking on a string option, such  as  the
  419. TITLE, will allow the user to edit the current title.   Clicking
  420. on one of the functions will allow the user  to  edit  the  last
  421. entered function, even if it contained  an  error  and  was  not
  422. currently displayed on  the  screen.   Clicking  on  the  MARKER
  423. option will cause all ten markers to be displayed.  A marker  is
  424. then selected by clicking on it.  To turn markers off,  type  in
  425. the command Markers NO.
  426.  
  427. Certain options, such as axis directions, can only be set before
  428. a file is plotted or a function is drawn.   Thus,  when  setting
  429. new options for the next dataset, only those options  which  can
  430. be changed will be presented.
  431.  
  432. 9.  FILE READING
  433.  
  434. DataPlot2.1 reads each file to be plotted several  times.    The
  435. first time is to activate any options that may  be  included  in
  436. the file.  The second time, the file  is  reopened,  the  option
  437. lines are skipped, and the data are read.  If autoscaling is  in
  438. effect, then the first data file may be read an  additonal  time
  439. to determine the minimum and maximum values.  The file will  not
  440. be read to determine the minimum and maximum values if they have
  441. been set by the appropriate options.  If a paper plot  is  made,
  442. then the file is read another two times to replot the data to  a
  443. bitmap.  Therefore, KYBD: may not be used as a file name.
  444.  
  445. 10.  CROSSHAIRS
  446.  
  447. When the CrossHairs mode is selected  from  the  mouse  menu,  a
  448. small set of crosshairs will appear on the  screen  outside  the
  449. plot area, and the pointer will  be  different.    Clicking  the
  450. mouse inside the plotting area will  result  in  the  crosshairs
  451. being drawn at the selected point and the  corresponding  values
  452. of X and Y appearing in the title bar.  To exit this mode, click
  453. the mouse outside the plotting area, or press a key.
  454.  
  455. 11.  FUNCTIONS
  456.  
  457. DataPlot can  do  manipulation  of  the  data  points  with  the
  458. FUNCTION options.  For instance the functions
  459.  
  460.                 (abs(1.56-tan(y)))^.5
  461.  or
  462.                 sqrt(x^2 + y^2) + (cos(x))^2
  463.  
  464. could  be  used.    Specifying  either  FUNCTION  or   YFUNCTION
  465. specifies an operation on the Y-axis values of the plot, whereas
  466. XFUNCTION specifies an operation on  the  X-axis  values.    The
  467. functions are applied to the x and y values  as  read  from  the
  468. dataset file.
  469.  
  470. The following function can be used to  convert  from  a  six  or
  471. eight digit date in the format YYMMDD to a  year  +  approximate
  472. fractional year format  for  plotting,  and  may be  invoked  by
  473. specifying the DATE keyword:
  474.  
  475. int(x/10000)+int(frac(x/10000)*100-1)/12+int(frac(x/100)*100-1)/365
  476.  
  477. The function will be compiled and optimized  to  the extent that
  478. successive operations  using  constants  will  be  evaluated  at
  479. compile time.
  480.  
  481. 12.  MACROS
  482.  
  483. DataPlot2.1 has a macro language which is useful  for  repeating
  484. plots.    This  macro  language  consists  of  all  the  options
  485. previously discussed, plus the following commands.  Case is  not
  486. significant, and commands may be  truncated  to  three  or  more
  487. characters.
  488.  
  489.   NEWPLOT          (Clear screen for new plot)
  490.  
  491.   DATASET filename (Plot this dataset)
  492.  
  493.   DRAWFUNCTION expression,xmin,xmax  (Draw  this  function  from
  494.                                       xmin to xmax)
  495.  
  496.   RESCALE [Xmin,Xmax,Ymin,Ymax]      (Auto rescale and replot)
  497.  
  498.   CROSSHAIRS        (Start interactive crosshairs)
  499.  
  500.   SCREENPRINT Epson, Epson2x, LaserJet (Copy the screen to the dot
  501.                      matrix printer on a pixel to pixel basis.)
  502.  
  503.   SCREENDUMP        (Print the screen to your Preferences selected
  504.                      printer using your Preferences selected options.)
  505.  
  506.   PRINTERPORT port  (PAR: is the default)
  507.  
  508.   PAUSE message     (Prints message, waits for key or mouse)
  509.  
  510.   BEEP              (Beeps)
  511.  
  512.   SPEAK message     (Speaks the message)
  513.  
  514.   PLOTTEXT "text" color xval,yval  (Places text on the plot)
  515.  
  516.   PRINTERPLOT Epson, Epson2x [width, height, left margin]
  517.                      (Makes a dot-matrix paper plot in portrait
  518.                       orientation only, with the 2x indicating
  519.                       double strike.  [Optionally, one may specify
  520.                       width and height in cm, and left margin in
  521.                       character spaces.])
  522.  
  523.   PRINTERPLOT HPGL          (Makes a paper plot in the HP
  524.                              Graphics Language)
  525.  
  526.   PRINTERPLOT PREFERENCES   (Makes a paper plot to the
  527.                              preferences selected dot matrix
  528.                              printer through the PLT: software)
  529.  
  530.   PRINTERADVANCE TOP or NNN  (advance printer to top of form, or
  531.                               advance printer NNN lines)
  532.  
  533.   PRINTFILE filename  (copy file "filename" to the printer)
  534.  
  535.   PRINTLINE text     (copy the line of text to the printer)
  536.  
  537.   IFFSAVE iffname   (Save screen as IFF ILBM file, about 41K
  538.                      free space is required)
  539.  
  540.   OnError WAIT, EXIT, or CONTINUE    (Macro error response,
  541.                    WAIT waits for the user, EXIT terminates
  542.                    DataPlot2.1, CONTINUE ignores the error)
  543.  
  544.   USE YES or NO     (Use or ignore in-file options)
  545.  
  546.   QUIT              (Quit DataPlot2.1)
  547.  
  548. An unrecognized macro command  will  be  executed  as an option.
  549. Error handling can be specified for macro file  execution.    If
  550. OnERROR WAIT has been set (the default) then  execution  of  the
  551. macro will  stop  with  an  error  message  and  wait  for  user
  552. intervention, which can be to exit the macro or to continue.  If
  553. OnERROR EXIT has been  set,  then  DataPlot2.1  will  exit on an
  554. error.  If OnERROR CONTINUE has been  specified,  then the error
  555. will be ignored and execution of the  macro  will  continue with
  556. the next command.
  557.  
  558. The 2x suffix for Epson printer plots makes a double  strike  to
  559. make the print darker.
  560.  
  561. For interactive selection, a question mark (?) may be used for a
  562. command or for a command argument.  The user  will  be  prompted
  563. for the argument to be used (e.g.  DATASET ?).   A user supplied
  564. default value may be entered following the question mark,  as in
  565. these two examples:
  566.  
  567.   DataSet ? data1        (The user must select a dataset,
  568.                           data1 is provided as the default)
  569.  
  570.   ? screenprint         (The user must select a command,
  571.                          screenprint is the default)
  572.  
  573. If there is a file named DataPlot.init in the S: directory, then
  574. it will be executed upon startup.  Such a file could  have  your
  575. choice of screen colors or depth.  Then if there is a MACRO.AUTO
  576. file in the default directory, it too will be  executed.    Even
  577. though DataPlot2.1 does not  have  an  AREXX  port,  it  can  be
  578. controlled by a script file though  the  MACRO.AUTO  file.    An
  579. automated system could collect  data  from  a  data  acquisition
  580. system,  write  an  appropriate  MACRO.AUTO   file,   then   run
  581. DataPlot2.1 to generate a printer plot.
  582.  
  583. A plot can  be  saved  as  a  macro,  which  can  be  edited  by
  584. MicroEmacs,   for   example.      The   commands   NewPlot   and
  585. ScreenResolution are not included when a  macro  is  saved,  and
  586. must be added by the user.    The  NewPlot  command  erases  any
  587. internally stored macro commands in the history buffer.
  588.  
  589. 13.  PRINTERPLOT
  590.  
  591. A  paper  copy  of  the  screen  plot  can  be  made  using  the
  592. PrinterPlot (or PAPERPLOT) command.  Before using  this  command
  593. from a macro, the PrinterPort command should be used to  specify
  594. the output device, whether it is PAR:, PLT:, or  a  file.    The
  595. PrinterPort should not be specified as PRT:  for  a printer plot
  596. because the Amiga Operating System  will  not  pass  the  escape
  597. sequences to the printer as required  for  bit-mapped  graphics.
  598. If NULL: is specified as the PrinterPort, then no output will be
  599. sent to the printer.  This is internal to DataPlot2.1  and  does
  600. not require a NULL: device driver.
  601.  
  602. 14.  PLOTTEXT
  603.  
  604. Text can be positioned on a plot with this command.   After  the
  605. user selects this mouse menu command,  the  text  color  can  be
  606. selected with a mouse click, and then the text may be typed  in.
  607. Next, the text may be positioned on the plot by moving the mouse
  608. and clicking at the desired location.
  609.  
  610. When used in a macro, the format is:
  611.  
  612.   PlotText "the text" textcolor xposition,yposition
  613.  
  614. where the desired  text must be in quotes if it is more than one
  615. word.  The arguments may be separated by commas or spaces at the
  616. user's option.  The x and y positions are  given  in  the  scale
  617. coordinates (the values printed along the axes).  A warning note
  618. will appear briefly on screen if the position is out  of  range.
  619. If the text color, an integer from 1 to 31, is greater than that
  620. allowed by the current screen depth, then it will be set to  the
  621. maximum number permitted.
  622.  
  623. 15.  RESCALE and REPLOT
  624.  
  625. This command is useful when multiple datasets are plotted on one
  626. screen with autoscaling selected.  Only  the  first  dataset  is
  627. used to determine the scaling.   Consequently,  subsequent  data
  628. points or even entire datasets may be out of range.  The RESCALE
  629. macro, or the mouse menu option Rescale and Replot (R),  may  be
  630. used to automatically set new autoscaling  limits  so  that  all
  631. points will be in range.  The datasets will be  read  again  and
  632. replotted.  DataPlot will attempt to rescale such that  PLOTTEXT
  633. strings will also be in range.
  634.  
  635. Values for Xminimum, Xmaximum, Yminimum,  and  Ymaximum  may  be
  636. entered on the line with RESCALE.  These  values  will  be  used
  637. for rescaling, instead of the default range if desired.  This is
  638. useful for zooming in on a section of data.    A  default  value
  639. will be used where a new value is omitted.   For  instance,  the
  640. macro command
  641.  
  642.     RESCALE ,,0,1
  643.  
  644. would use the default extreme values for Xminimum and  Xmaximum,
  645. but would set Yminimum to 0 and Ymaximum to 1, and  then  replot
  646. the datasets.
  647.  
  648. 16.  SKETCH FREEHAND
  649.  
  650. This mode permits the user to select a color and turn on  pixels
  651. by moving the mouse over  them  while  holding  the  left  mouse
  652. button down.  The results are  only  shown on the screen and can
  653. only  be  copied to a printer through  the ScreenPrint commands.
  654.  
  655. 17.  HPGL and PLT:
  656.  
  657. The Hewlett-Packard Graphics Language is used to  drive  HP  pen
  658. plotters.   It  can  also  be  used  to  drive  any  preferences
  659. supported graphics printer through the use of the  PLT:  device,
  660. which was written by Rich Champeaux and Jim Miller.    The  PLT:
  661. device accepts HPGL commands and produces a raster  image  which
  662. can be displayed on the Amiga screen, or sent  to  the  printer.
  663. The instructions for installing the PLT: device are included  in
  664. the PLT.doc file.  All of the PLT software  is  included  at  no
  665. extra cost.  If PaperPlot HPGL is selected, then the output will
  666. be a file of HPGL commands.  That file can be  copied  to  PLT:S
  667. for a screen preview, or copied  to  PLT:  for  output  to  your
  668. printer.  It is an ASCII file, and can be edited, if  necessary.
  669. Pen 1 is used for the text, with  pens  2  through  8  used  for
  670. plotting the data.  The  pen  number  is  incremented  for  each
  671. dataset.  The CurveColor  option  will  override  the  automatic
  672. increment.  PLT: uses black as the default color for  all  pens.
  673. The CLI command
  674.  
  675.               copy hpglfile to plt:/000-1/f00-3/
  676.  
  677. will produce a plot with pen 1 set to black and a thickness of 1
  678. pixel, and with pen 2 set to red and a thickness  of  3  pixels.
  679. The three consecutive  digits  specify,  in  hex,  the  relative
  680. amounts of red, green, and blue.  The  dashed  number  specifies
  681. the pen width in pixels.
  682.  
  683. If you have sufficient ram, then you can  specify  PLT:  as  the
  684. output device directly from DataPlot, with any color options you
  685. desire.  If your  printer  is  monochrome,  then  color  options
  686. should not be specified.
  687.  
  688. Specifying PLT:S for a screen preview directly from  DataPlot2.1
  689. has sometimes resulted in corrupted RAM.  You are hereby warned!
  690.  
  691. If  you  intend  to  install  PLT:,   then   please   read   the
  692. instructions.  Essentially, it consists of  adding  a  MountList
  693. entry in DEVS:, copying  the  plt-handler  to L:,  and assigning
  694. PLOTDATA: to a subdirectory containg the  plot  fonts.  A  batch
  695. file is included for automatically modifying your MountList, and
  696. copying the PLT-handler to L: for you.  It also assigns PLTDATA:
  697. to the directory containing the fonts  and  a  font  list.  This
  698. file should only be executed once!  You may want to  modify your
  699. Startup-Sequence to Mount PLT: and to  Assign  PLTDATA:  to  the
  700. appropriate directory.
  701.  
  702. 18.  DRAWFUNCTION
  703.  
  704. DataPlot2.1 will also plot functions entered by the user, either
  705. in a macro or interactively from the mouse menu.   The  function
  706. must be a function of x only,  unlike  functions  which  can  be
  707. applied to data points.  If no data has yet been  plotted,  then
  708. the limits which are entered for plotting the function will also
  709. be used to auto-scale the plot.  The same set of functions  used
  710. for manipulating the data points is available for DrawFunction.
  711.  
  712. 19.  SCREENPRINT
  713.  
  714. Under the ScreenPrint menu item,  the  user  may  select  either
  715. portrait (vertical) or landscape (sideways)  orientation  for  a
  716. pixel to pixel printer copy of the plot window.  Any pixel  that
  717. is other than the background color (color 0) will be printed  as
  718. a dot on the printer.  The size of the printout depends  on  the
  719. size and resolution of the plot window and the orientation.   If
  720. the plot is  too  large  to  fit  the  page  with  the  selected
  721. resolution, the resolution is  automatically  increased in order
  722. to shrink the size of the plot.  The printer must be  compatible
  723. with the Epson graphics commands for this to work properly.
  724.  
  725. 20.  GRAPHICDUMP
  726.  
  727. Selecting GraphicDump will result in a printer  output  using  the
  728. Preferences selected options to the Preferences selected  graphics
  729. printer.  The appearance of the output  can  change  greatly  with
  730. size, color, and the graphics options.    The  best  results  will
  731. probably be obtained by using a black background (color  0  0,0,0)
  732. with white curves (color 1 15,15,15) using a screendepth of 1  for
  733. a plot with only 2 colors.  The Preference option  for  "negative"
  734. should also be selected.  Other combinations will also work.
  735.  
  736. 21.  SAMPLE FILES
  737.  
  738. There are sample data files and macro files on  the  DataPlot2.1
  739. disk.  Please examine them to see examples of the proper format.
  740.  
  741. 22.  THE END
  742.  
  743. Your suggestions for improving DataPlot are welcome.
  744.  
  745.  
  746.  Bytes and Bullets
  747.  Route 3 Box 3532
  748.  Manchester TN 37355
  749.  (615)-596-2077
  750.